home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / vbbs530.zip / VBBS530.DOC < prev    next >
Text File  |  1991-11-06  |  69KB  |  1,655 lines

  1.  
  2.  
  3.  
  4.  
  5.                        ▒▒▄ ▒▒▄ ▒▒▒▒▒▄  ▒▒▒▒▒▄  ▒▒▒▒▒▒▄
  6.                        ▒▒█ ▒▒█ ▒▒█▀▒▒▄ ▒▒█▀▒▒▄ ▒▒█▀▀▀▀
  7.                        ▒▒█ ▒▒█ ▒▒▒▒▒█▀ ▒▒▒▒▒█▀ ▒▒▒▒▒▒▄
  8.                         ▒▒▒▒█▀ ▒▒█▀▒▒▄ ▒▒█▀▒▒▄  ▀▀▀▒▒█
  9.                          ▒▒█▀  ▒▒▒▒▒█▀ ▒▒▒▒▒█▀ ▒▒▒▒▒▒█
  10.                           ▀▀    ▀▀▀▀▀   ▀▀▀▀▀   ▀▀▀▀▀▀
  11.  
  12.  
  13.                                       *
  14.  
  15.                              The Virtual BBS/NET
  16.                                 Version 5.30
  17.  
  18.                         (C) Roland De Graaf 1990, 1991
  19.  
  20.                               4246 Elisabeth Ave
  21.                               Holland, MI 49424
  22.  
  23.                                       *
  24.  
  25.  
  26.  
  27.  
  28.  
  29.    -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  30.  
  31.  
  32.                         Terms of Use & Registration
  33.  
  34.                   The Virtual BBS and associated files are:
  35.                    Copyright (C) Roland De Graaf 1990, 1991
  36.  
  37.  
  38.   This Virtual BBS/NET software has been made available to you as SHAREWARE,
  39.      and is provided to you as such with hope that after evaluating this
  40.        software, you will join our growing family of SySops nationwide.
  41.  
  42.           Your possesion of this program entitles you to evaluate it
  43.              for a reasonable period of time prior to registration
  44.                and in NO case, shall this evaluation period go
  45.                  beyond 3 months without resulting in either
  46.                    formal registration, or discontinuation
  47.                      of it's use. You are encouraged to
  48.                        distribute VBBS/NET to others
  49.                          in it's original ZIP only
  50.                            and under this title:
  51.  
  52.                                 VBBS530.ZIP
  53.  
  54.                                     ***
  55.  
  56.  
  57.  
  58.          The author shall not be liable for any damages arising
  59.          from the use of this software, or the VirtualNET network.
  60.  
  61.            By using the software you agree to the above terms.
  62.  
  63.  
  64. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  65.  
  66.                                   ==*==
  67.  
  68.                             TABLE of CONTENTS
  69.                          -=-=-=-=-=-=-=-=-=-=-=-
  70.  
  71.  
  72.                SOFTWARE OVERVIEW............................... 1
  73.  
  74.                VBBS INSTALLATION............................... 4
  75.  
  76.                CONFIGURATION (Vconfig.exe)..................... 4
  77.                     Main Config................................ 5
  78.                     Channel Config............................. 6
  79.                     Database Config............................ 7
  80.                     Paths Config............................... 9
  81.                     Security Config............................ 10
  82.                     U/L D/L Protocols.......................... 10
  83.                     Network Config............................. 11
  84.                     Events Config.............................. 12
  85.                     Control Panel Config....................... 12
  86.                     Doors Config............................... 13
  87.                     Voting Booth............................... 13
  88.                     Random Messages............................ 13
  89.                     Archive View Config........................ 13
  90.                     Text sections.............................. 13
  91.                     VBBS Diagnostics........................... 13
  92.  
  93.                RUNNING VBBS.................................... 14
  94.  
  95.                FIRST TIME STARTUP...............................15
  96.                     WFC  (Control Panel)....................... 15
  97.            
  98.                CREATING THE SYSOP ACCOUNT...................... 16
  99.                     Online F-keys.............................. 16
  100.                     User Editor................................ 17
  101.                     User Defaults.............................. 18
  102.  
  103.                DEFAULT SETUP................................... 19
  104.                     Main Menu.................................. 20
  105.                     Local/Networked Message Bases.............. 20
  106.                     E-Mail..................................... 20
  107.                     Files Transfer Area........................ 20
  108.                     Mutiluser Teleconferencing................. 26
  109.                     Voting..................................... 26
  110.                     Doors...................................... 26
  111.                     Autoposts.................................. 26
  112.                     Random Messages............................ 26
  113.                     Chat Screens..............................  26
  114.                     Taglines..................................  26
  115.  
  116.                CUSTOMIZING VBBS................................ 27
  117.                     VScripts................................... 27
  118.                     Function Blocks............................ 28
  119.                     Source Code................................ 29
  120.  
  121.                VBBS OPTIMIZATION............................... 30
  122.                     Use of RAMdrives........................... 30
  123.  
  124.                SECURITY........................................ 31
  125.  
  126.                EXPLAINATION OF FILES........................... 32
  127.  
  128.                VirtualNET...................................... 33
  129.  
  130.                REGISTRATION.................................... 34
  131.  
  132.                THE FUTURE...................................... 35
  133.                     
  134.                ACKNOWLEGEMENTS................................. 36
  135.  
  136.                ABOUT THE AUTHOR................................ 37
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.       -------------------------------------------------------------
  145.                           V I R T U A L  B B S
  146.       -------------------------------------------------------------
  147.                                   - 1 -
  148.  
  149.                               VBBS Overview
  150.                              ~~~~~~~~~~~~~~~
  151.  
  152.    Welcome to The Virtual BBS/NET. VBBS, as it is known, is a new and
  153. fast developing Electronic Bulletin Board software designed for MS DOS
  154. compatible computers. VBBS is a very unique and powerful telecommunications
  155. tool which you will discover features nearly limitless configurability.
  156. The powerful configuration available to you is enabled in part through
  157. the use of a special telecommunications oriented script language called
  158. Vscript. Through the use of these scripts, a SysOp is easily able to
  159. achieve total "look and feel" control over VBBS by simply modifying
  160. and customizing the vscripts with any ascii editor. A built in script compiler
  161. produces code from the scripts which loads and executes very quickly.
  162. Configurable onboard databases are used to store public and private messages
  163. as well as file listings, descriptions, and other information. The number of
  164. databases, as well as their size is limited only by the size of your hard
  165. disk, and the datafields can even be used for a special database creation of
  166. your own.
  167.    Although it is not necessary for a VBBS sysop to become familiar with
  168. the scripts in order to use VBBS, the heretofor unknown flexibility that
  169. is available to you, enables amazing configurability options that are
  170. limited only by your imagination.
  171.    Another configuration tool which is NEW to the VBBS program are
  172. "Definable Function Blocks". This ingenious device allows you to
  173. actually define the function of each key presented to a user of your
  174. BBS by simple editing of an ascii textfile (see Function Blocks).
  175.   VBBS is fast and is so without any loss to it's flexibility unlike
  176. normal 'fixed' code BBS software. Multiple Node, Multiple Network,
  177. VBBS is a feature laden BBS software that is as well the most
  178. configurable BBS program available anywhere.
  179.  
  180.  
  181.                               -2-
  182.    VBBS is a Multiuser BBS which simply requires a seperate commandline
  183. (bbs <channel#>), for each node you wish to run under your multitasking
  184. software or Lan. Although VBBS multitasks as well as Windows3 and
  185. Desqview will allow, and in fact includes a Desqview aware commandline
  186. switch option, it is the author's contention that superior multitasking
  187. performance with all communication software is best acheived through the
  188. use of a LAN at this time. A seperate DOC file called MULTIUSE.DOC is
  189. in the process of being prepared and will be available independently of
  190. this documentation.
  191.  
  192.    VBBS can be run standalone, or as a door from inside virtualy ANY
  193. other BBS software or matrix logon. (wwiv sysops please see
  194. VWWIVSYS.DOC)
  195.  
  196.    VBBS creates both chain.txt and dorinfo1.def formats for doors, and
  197. it releases all but 18k of Ram (shrinks out of memory) for all doors as
  198. well as events, freeing up more memory for other programs and multitasking.
  199.  
  200.    VirtualNET, the name of the VBBS Network, is a standard feature
  201. of VBBS and is extremely easy to set up and use. It uses Zmodem
  202. transmission of compressed mail packets to provide maximum speed and
  203. efficiency. VirtualNET openly welcomes all, and you are encouraged to
  204. come online as a new VirtualNET node at any time. (see NETGUIDE.DOC)
  205.  
  206.    Above all else, VBBS is a BBS software in motion. There is a certain
  207. excitement in it's continuing development that is unmatched within the
  208. BBS community. It is hoped that if you are now installing VBBS for the
  209. first time, this experience will lead you to become part of that motion,
  210. a part of our developing VirtualNET family, and a part of what is sure
  211. to be a bright future for this remarkable new program.
  212.  
  213.  
  214.  
  215.  
  216.  
  217.                                 -3-
  218.  
  219.         Some of the current BBS features in VBBS include:
  220.  
  221. - Extremely easy setup
  222. - Zmodem and Zmodem Batch downloads and uploads.
  223. - Automatically adds Zipcomnt.txt to uploads.
  224. - Cancelable "logoff after xfer" feature
  225. - Files attached to email local and Network
  226. - Automated offline file requesting
  227. - Automated Networked File requesting (networked feature).
  228. - Surveys and Voting
  229. - Networkable "autoposts"
  230. - Multiuser Teleconferencing with port status and paging
  231. - Prompts for prepared text uploads in email and messaging.
  232. - Easy to use quoting feature in email and messaging
  233. - Configurable 'N' scans
  234. - Easy to set up Games and other external online programs
  235. - Save to ascii text any public or private message
  236. - Unlimited number of subs and file dirs
  237. - User defined macros
  238. - system bulletins
  239. - Random messages (up to 3 lines)
  240. - Up to 20 timed events per day.
  241. - Automatic message from the sysop New user email.
  242. - User definable ansi screen colors (including background color)
  243. - File archive viewing.
  244. - Access coding
  245. - Unique Dual purpose (ansi color and ascii) menuing system.
  246. - Full messaging and file search functions
  247. - Efficient binary storage of messages and all system text
  248. - Built in daily clean-up.
  249. - System activity display at logon
  250. - Fast Login from console
  251. - Mail forwarding (across multiple networks even)
  252. - FULLY WWIVnet & WWIVLink Capable
  253. - Assignable function keys at WFC
  254. - Highly informational and customizable WFC.COM screen
  255. - Full CD Rom or WORM capable databases
  256. - Runs as a door in whole OR in components from nearly any other BBS prog
  257. - Extensive log information
  258. - Macro capable Networking software included
  259. - Built in Ansi Autodetect
  260. - Read and write Email from WFC
  261. - Enhanced Sysop functions
  262. - Split Screen Chat
  263. - "Pseudo" Dos (allows sysop to perform Dos functions w/ user online)
  264. - Multi-Mail (up to 9 lists)
  265. - Multinet CC:s
  266. - SysOp security uploads
  267. - Uses full advantage of DSZ for upload and log info
  268. - Improved multiuser ability
  269. - Full Ansi Taglines (can be made with an ascii editor or ansi draw program)
  270. - Built in BBS Diagnostics
  271. - Definable Function Blocks
  272. - Built in Ansi Color Full Screen Editor
  273. - Built in spell chek
  274. - Autovalidation of SysOps
  275.  
  276. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  277.  
  278.                                -4-
  279.             ┌─────────────────────────────────────────┐
  280.             │       *   - VBBS Installation -  *      │
  281.             └─────────────────────────────────────────┘
  282.  
  283.   Installation of VBBS is quite straight-forward. It is perhaps the
  284.   EASIEST BBS software in the known world to install.
  285.  
  286.  
  287. New Installations:
  288. ------------------
  289. 1) UNZIP the contents of VBBS530.ZIP to the diectory named VBBS which
  290.    you have created.
  291.  
  292. 2) Run INSTALL.EXE (choose NEW Installation YES when prompted)
  293.  
  294. 3) Verify the configuration as Vconfig is presented, particularly
  295.    in MAIN.CFG and MOST importantly CHANNELS.CFG. All Single node VBBS
  296.    installations use the same command line; BBS 1 (naming channel # 1)
  297.    You just need to correctly identify your modem PORT # in the
  298.    channel 1 config.
  299.  
  300.  
  301.  
  302. Existing Installations:
  303. -----------------------
  304. 1) UNZIP the contents to VBBS530.ZIP to a temporary dir.
  305. 2) Backup your LOGIN .ANS, .ASC LOGOFF.TXT NEWUSER.TXT and .DAT files
  306.    (existing .CFG files will not be overwritten)
  307. 3) Run INSTALL.EXE (choose NO at new installation prompt)
  308. 4) Same as 3 for New Installation
  309. 4) Copy your backup VBBS data files to your VBBS directory and
  310.    your .ANS, .ASC and .TXT files to the directory you have defined
  311.    for TEXT files in PATHS.CFG
  312.  
  313.                  -  Configuring The Virtual BBS/NET -
  314.  
  315.     Using the VCONFIG.EXE configuration utility, you can configure main,
  316.     Channel, databases, system paths, security levels,
  317.     upload protocols, download protocols, VirtualNET Network
  318.     data, timed events, assignable Function Keys, Door set up, Voting
  319.     questions, random messages, textfiles and Archive Viewing
  320.     configurations.
  321.  
  322. NOTE:
  323. MOST of these configurations are properly set at default settings and
  324. configured for you already. The Following configuration is the ONLY
  325. configuration required in MOST installations to effect a first time
  326. start up:
  327.           {In Main.cfg} BBS Name, SYSOP Name, System Password.
  328.           {In Channel.cfg} Set channel 1 to correct modem port.
  329.  
  330.    It is easy to use the Vconfig configuration util at any time to do
  331. additional setup and further configuration.
  332.  
  333.  
  334.                                ==*==
  335.                                 -5-
  336.  
  337.                               Main.cfg
  338.                              ~~~~~~~~~~
  339.  
  340. 1. Main Settings are:
  341. BBS Name          -  The name of your system.
  342. SYSOP Name        -  Your name or alias.
  343. Timeout           -  The number of "ticks" to wait before inactivity timeout.
  344.                      A "tick" is a varying unit of time delay and you may need
  345.                      to adjust this number as per the speed of your CPU.
  346. New User Security  - Security level assigned to new users.
  347. New User Time      - Time given to new users.
  348. Start-Up Script    - Script file to run first when a user logs in.
  349.                      The name entered should be 8 characters or less, and
  350.                      DO NOT enter in any extension. ("Start" is the
  351.                      default start-up script, start.v)
  352. PAUSE String       - Default string of text to output for PAUSE statement.
  353. Idle Modem         - What do you want the modem to do when the BBS is
  354.                      not available to take a call?
  355.                      (ie system down, editing user data, etc.)
  356. Registration Number- Your Registration Number.
  357. New User Password  - Setting to ALL SPACES disables this function.
  358.                      (If you are not using this setting, SPACE over it once!)
  359. Blank Screen WFC   - How many seconds to display WFC after inactivity
  360.                      WFC screen can be recalled by using "?")
  361. Reserve Space (kb)  - When a user goes to upload, they are informed of the
  362.                      free space available on the upload drive. This option
  363.                      lets you "shield" a set amount of free space from
  364.                      the amount actually available. Note: When you as SysOp
  365.                      access the free space display, the ACTUAL free space is
  366.                      indicated.
  367. Using Watch.Com    - IF you use WATCH.COM to monitor the BBS, by turning
  368.                      this option on, VBBS will set WATCH to OFF when
  369.                      appropriate. Watch.com is a utility by   which is
  370.                      one of many such utils that reboot your computer in
  371.                      the event that x number of rings are sensed w/o a connect
  372.                      NOTE: If using WATCH.COM or facimile, be sure to
  373.                      load the utility BEFORE the program in your
  374.                      autoexec.bat file.
  375. Allow Handles      - "Yes" will allow New Users to use "Aliases" on your
  376.                      system. "No" will require that they use Real Names
  377.                      only.
  378. Daily Cleanup      - Time of Day to do auto-cleanup, in hh:mm format.
  379.                      Disable option with 00:00.
  380. Allow 255 Remote   - If set to No, will not allow any user to have 255 SL
  381.                      from a remote login. Security Feature.
  382. System Password    - A required password to be entered by those logging in
  383.                      at 255 security level (including you). Security Feature.
  384. Registration Code  - Special code to enable your registered board status.
  385.  
  386. ------------------------------------------------------------------------------
  387.                                 -6-
  388.  
  389.                              Channel.cfg
  390.                              ~~~~~~~~~~~
  391.                               1 thru 64
  392.  
  393. COM Port     - Your Modem port #
  394. Base Address - Configurable but set as default
  395. IRQ (hex)    -  "                         "
  396. Baud              - Maximum baud rate.
  397. Init String - Modem Initialization String
  398. Locked Baud Rate  - Y/N
  399. Hardware (RTS/CTS) Handshake  - Y/N
  400.  
  401. Note: For most installations, all that should be entered is the Com
  402.       Port #.
  403.  
  404.  
  405.  
  406. -------------------------------------------------------------------------------
  407.  
  408.  
  409.                                 -7-
  410.  
  411.                             Database.cfg
  412.                            ~~~~~~~~~~~~~~
  413.    At the heart of VBBS are the DATABASES. They are used for such
  414.    functions as Message Bases, File directories, email, text sections
  415.    and Voting. Databases can be setup or altered in Vconfig by the SysOp
  416.    at any time. Remember that you MUST make sure that the directory you
  417.    name in Dadtabase config actually exists. ONLY Databases which
  418.    contain actual files need to be named to their own sub directory.
  419.    Also note that both tha "DB" dir where all the non-file related
  420.    database data is stored, and the Sysop "UPLOAD" dir MUST be a
  421.    subdirectory of VBBS.
  422.  
  423.         Databases in VBBS can be created for any purpose. Databases in
  424. use and configured for you here are Email (E type), Public messages (A
  425. type), File Transfer (F type), and Textfiles section (T type). A fifth
  426. database type (O type) is available for your use in creating other types
  427. of databases for other purposes.
  428.  
  429. Use of DBGROUPs:
  430.  
  431. (This shows the layout of the example DATABASE.CFG included with the
  432. default setup.)
  433.  
  434. DBGROUP E (as in Email)
  435. E 1   Email              Private
  436. E 2   Return receipts    Private   (VBBS sends back one line
  437. confirmations when a local or networked user has recieved your mail)
  438.  
  439. DBGROUP A (for Message bases)
  440. A 1   General            Public
  441.  
  442. DBGROUP F (For File Directories)
  443. F 1   General Files      Public
  444.  
  445. DBROUP 0 (For custom database configuration)
  446.  
  447. ** Databases can be given any letter designator between A and Z. To
  448. have a SECOND and seperate Message AREA, you might create a NEW
  449. database with a "B" database type (for example).
  450.  
  451. To add more message bases to the BBS, simply add more databases to group A.
  452. To add more file directories to the BBS, simply add more databases to group F.
  453. ALL FILE DIRS REQUIRE A DIR ACTUALLY BE CREATED BY YOU. ALL MESSAGE
  454. DIRS ARE AUTOMATICALLY PATHED TO THE "DB" DIR DEFINED BY YOU IN
  455. PATHS.CFG AND DO *NOT NEED AN ACTUAL DIR OF THEIR OWN.
  456. Entries in your database configuration which have the same DB File and
  457. same DB Path specify the SAME database. So, be sure you give each databse
  458. a unique filename and its own unique sub-directory path.
  459.  
  460.  
  461.                            -8-
  462. 3. Database Configuration:
  463. Group             - The identifier for the database type (A-Z)
  464. File Name         - The filename of the database.
  465. File Path         - The pathname for the database.
  466. Long Name         - The long name of the database.
  467. Private?          - Private Database.
  468. VirtualNET Sub #  - VirtualNET Sub-board identification code.
  469.                          0 if not a net sub.
  470. Max Entries       - Max Entries per database. 0 means unlimited.
  471. Read SL           - Read Security Level. If user SL is less than this value,
  472.                     the database is invisible.
  473. Write SL          - Write Security Level. Each time a DB is executed, the
  474.                     special variable $WRITESL is updated to reflect this
  475.                     value.
  476. Access Flag       - Not associated with DBGROUP in any way. Group Codes
  477.                     let you restrict databases to certain groups.
  478.                     If the group code is zero, the feature is disabled for the
  479.                     database. If not, then a user must have a matching group
  480.                     code (or be SYSOP) to access the database.
  481. Age Limit         - Restricts database access from users below defined age
  482. WWIVnet           - WWIVnet Subtype (if any). See NETGUIDE.DOC
  483. WWIVLink          - WWIVLink Subtype (if any). See NETGUIDE.DOC
  484. Tagline           - Define tagline to be used in that database. 0=none
  485.                     1= Tagline.1  527= Tagline.527 etc..
  486.  
  487. -------------------------------------------------------------------------------
  488.  
  489.                                 -9-
  490.  
  491.                              Paths.cfg
  492.                             ~~~~~~~~~~~
  493.  
  494.  
  495. 4. System Paths:
  496. Main VBBS Directory - VBBS Home Directory:
  497.                       Executables *.FB and *.CFG files go here
  498.                       (This should be your current directory when you are
  499.                       executing the program.)
  500.  
  501. Scripts Directory   - Where VBBS expects to find any script files:
  502.                       *.LIT, *.COD, *.V
  503.  
  504. Data Directory      - Where VBBS expects to find system data files:
  505.                       USERFILE.DAT, USRMACRO.DAT, STATVBBS.DAT, CONNECT.DAT
  506.  
  507. Network Files       - Where VBBS expects to find network configuration files,
  508.                       and store net packets awaiting transfer.
  509.  
  510. System Text Files   - Where VBBS expects to find *.TXT, *.ANS, *.ASC files.
  511.                         (except Announce.txt and logoff.txt)
  512.  
  513. CONTROL.DAT Directory - Where VBBS will maintain the temporary system file,
  514.                         CONTROL.DAT. Use of a RAM Drive for CONTROL.DAT is
  515.                         highly recommended in multiuser VBBS installations.
  516.  
  517. Temporary Directory - The directory VBBS will use for temporary storage of
  518.                       incoming network packets and files. This directory
  519.                       you specify here should be not be used for any other
  520.                       purpose.
  521.  
  522. Database Dir        - Directory where VBBS will store all database data
  523.                       which is not related to actual files storage (ie.
  524.                       messages)
  525.  
  526.  
  527.  
  528. --------------------------------------------------------------------------
  529.  
  530.                                  -10-
  531.  
  532.                             Security Config
  533.                            ~~~~~~~~~~~~~~~~~
  534. MSL = Minimum Security Level required
  535.  
  536. 1) MSL to Autopost - Who gets to post Autoposts
  537. 2) MSL to email others - Who get's to use the basic email function
  538. 3) MSL to email sysop an attached file- Who gets to attach files to
  539.    email to the sysop
  540. 4) MSL to email others an attached file - Who gets to attach files to
  541.    other users (and across the network)
  542. 5) MSL to use Multimail features - Who get's to use Multimail
  543. 6) MSL to use email carbon copy feature - Who gets to use CC:s
  544. 7) upload/download ratio Upload to download ratio used by the system (if
  545.    any) This may be exemptable in the user editor.
  546. 8) Allow Sysop Validation- Enables/Disables Autovalidation of SysOps.
  547. A) Auto-Sysop Validation - Sets SL given to Visiting Sysop.
  548. B) Auto-SysOp Time Limit - Sets Visiting SysOp Time allowed on
  549.  
  550. ---------------------------------------------------------------------------
  551.  
  552.                       Download amd Upload Protocols
  553.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  554. 7. Download Protocols and 8. Upload Protocols:
  555.  
  556.   Each Protocol is configurable by:
  557.    1. Letter Pressed to Select
  558.    2. Name/Description of Protocol
  559.    3. DOS Command Line to run Protocol
  560.       %1 = Port #, %2 = Baud, %3 = FileName, %4 = HandShake
  561.    4. Batch Compatible?
  562.  
  563. *  Xmodem, Ymodem and Zmodem protocols have been preconfigured for you.
  564.  
  565.  
  566. ------------------------------------------------------------------------------
  567.  
  568.                                 -11-
  569.  
  570.                             Network Config
  571.                            ~~~~~~~~~~~~~~~~
  572. 9. Network Config
  573.  
  574. Net Low Time -  Begin time for accepting net xfers only (00 = disabled)
  575. Net High Time - End time for accepting net xfers only (00 = disabled)
  576. Net Redial Attempts - Number of attempts for connection to Host or
  577.                       remote system.  (default is 10 attempts)
  578. SYSTEM VirtualNET node # - Your systems Unique VirtualNET node number
  579. SYSTEM VirtualNET Config
  580.   SERVER VirtualNET Node # - VirtualNET node # of your host (Defaults to
  581.                              VirtualNET @1)
  582.   VirtualNET Network Password- Network Password assigned by Net
  583.                                coordinator
  584.   VirtualNET Server Distance-   Local/Long Distance. If set to Local, VBBS
  585.                                 will dialout whenever the Network message
  586.                                 threshold is met. Long distance will only
  587.                                 dialout once per day.
  588.   VirtualNET Server Threshhold- # of messages Vnet will allow before going
  589.                                 into Autodialout mode to Server. 0 = Never
  590.                                 autodial.
  591.   VirtualNET server macro- If your server is being run from inside another
  592.                          system or matrix Login, you may create a macro
  593.                          textfile for it and name it here. The macro.txt
  594.                          should go in your NETWORK directory. 
  595.                          (see Network.doc)
  596.  
  597. VirtualNET Clients Config - Information on systems to which you serve as
  598.                             host to (if any)
  599.  
  600. WWIVnet Config
  601.   SYSTEM WWIVnet Node # - Your WWIVnet node # (if any) NOTE: Do not set
  602.                           this to a WWIVnet node # unless you are running
  603.                           WWIVnet directly inside of the program
  604.   WWIVnet Data Dir Path - Where VBBS will find your WWIVnet DATA dir
  605.  
  606. WWIVLink Config
  607.   SYSTEM WWIVLink Node# - Your WWIVLink node # (if any)
  608.   WWIVLink Data Dir Path- Where VBBS will find your WWIVLink DATA dir.
  609.  
  610. Network Poll delay at WFC- Time interval (in seconds) between Auto-net
  611.                            dialouts from WFC
  612.  
  613.  
  614. ------------------------------------------------------------------------------
  615.                               -12-
  616.  
  617.                            Events Config
  618.                           ~~~~~~~~~~~~~~~
  619.  
  620. A. Events:
  621.  
  622. VBBS allows up to 20 timed events per day. Possibilites here include your
  623. daily external maintenance (usually done by a batch file), network dialouts,
  624. etc.
  625.  
  626. You can specify:
  627. Time - Time event runs
  628. Command - The DOS command line to execute
  629.  
  630. For a daily maintenance batch file,
  631. you might use EXTERNAL.BAT.
  632.  
  633. To automatically do a network dialout, use:
  634. VNET /NET
  635.  
  636. To automatically poll a remote system (which you serve as host to), use:
  637. VNET /DIAL<remote sys#>
  638.  
  639. VNET.EXE features a macro facility which makes it possible to access a
  640. VirtualNET BBS that is being run as a door or in a matrix logon. (see,
  641. NETGUIDE.doc)
  642.  
  643. -------------------------------------------------------------------------
  644.  
  645.  
  646.                            Control Panel
  647.                           ~~~~~~~~~~~~~~~
  648.  
  649.         In addition to other commands found in the Waiting For Call
  650. menu, VBBS allows you to assign up to 10 Function keys for whatever use
  651. you desire. At default, the F1 key is assigned to call a batchfile
  652. called Terminal.bat (but ofcourse can be anything you want). The F2 and
  653. F3 keys call up System Log and Network Log respectively using a List
  654. utility (not included).
  655.  
  656.  
  657. ---------------------------------------------------------------------------
  658.                                -13-
  659.  
  660.                             Doors Config
  661.                            ~~~~~~~~~~~~~~
  662.         In Doors config, you are prompted for the Name of the online
  663. game or other external program you wish to run, the security level required
  664. to access that program if any, and the name of the batchfile (including the
  665. .BAT extention) from which the program is run. VBBS shrinks out of memory for
  666. all external programs. You may use this to add, delete or modify your
  667. doors at any time. VBBS creates both  Chain.txt and Dorinfo1.def formats
  668. for your use. Those three parameters are all that need be defined. At
  669. the present time VBBS will NOT run older online programs that rely on
  670. DOS interupts.
  671.  
  672.  
  673. ----------------------------------------------------------------------------
  674.  
  675.                            Voting Booth
  676.                           ~~~~~~~~~~~~~~
  677.         There are two methods of employing the Voting fuction in VBBS.
  678. You may enter your survey questions from within Vconfig which will be
  679. displayed from the voting function from within the VBBS.EXE or, you can
  680. change the statement in the BBS1.V script to call "Link Vote.v" in place
  681. of where it calls "VOTE". The Vote.v and nags.v are included in the
  682. distribution archive for this use should you decide to use the vscript
  683. function in place of the internal one.
  684.  
  685.  
  686.  
  687.  
  688.  
  689. ----------------------------------------------------------------------------
  690.                           Random Messages
  691.                          ~~~~~~~~~~~~~~~~~
  692.  
  693.         VBBS features a "random messaging" function that can display
  694. one, two, or three line quips, quotes or whatever upon display and
  695. redisplay of the main menu. These messages are called randomly by the
  696. program and are entered in Vconfig.
  697.  
  698.  
  699.  
  700.                            Archive View
  701.                           ~~~~~~~~~~~~~~
  702.  
  703.         VBBS allows you to view the contents of a compressed file within
  704. the File Transfer Directories. Configured at default are the .ZIP, .ARC,
  705. .ZOO, .LZH and .ARJ archive extentions.
  706.  
  707.  
  708.                           Text Sections
  709.                           ~~~~~~~~~~~~~
  710.          With the internalization of the Textfile/Bulletin section,
  711. setup of the different texfile directories is now done here.
  712.  
  713.                          VBBS Diagnostics
  714.                         ~~~~~~~~~~~~~~~~~~
  715.          VBBS now gas the ability to run diagnostics on your setup. If
  716. you recieve an error, go here and run the diagnostics. Chances are, it
  717. will show you where your error is.
  718.  
  719.  
  720. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  721.  
  722.                                 -14-
  723.  
  724.                              Running VBBS
  725.                             ~~~~~~~~~~~~~~
  726.  
  727.  
  728. When running VBBS, a Ram Resident BBS.EXE controls the program and
  729. should be used as the ONLY means of starting VBBS. The EXE is used
  730. to transfer needed information to the program.
  731.  
  732. The basic syntax for bringing VBBS online is:
  733.  
  734. BBS <channel #>
  735.     (NOTE that ALL single node intallations use the "BBS 1" command
  736.     line)
  737.  
  738. <port #> is a number from 0 to 4.
  739.     Ports 1 to 4 correspond to COM1 to COM4.
  740.  
  741.     BBS 0 specifies LOCAL MODE execution only, using the console keyboard,
  742.     and bypassing WFC initialization.
  743.  
  744.  
  745. Command line options include:
  746.  
  747. /AC - Use this when running VBBS as a door, or from a matrix logon.
  748.       Example: BBS 1 /AC
  749.  
  750.  
  751. /DV - Turns on Desqview Awareness. When this option is on, VBBS will
  752.       multitask better under desqview. When the program is idle,
  753.       (waiting for a call, or waiting for user input), more CPU time
  754.       is given to other tasks that may be running on the system.
  755.  
  756. /WWIV -  command for logging user to VBBS being run as a door from WWIV,
  757.          VBBS or any BBS program using the chain.txt format. (see .doc)
  758.  
  759.  
  760.  
  761.        -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  762.  
  763.                                -15-
  764.                        ---------------------
  765.                         First Time Start up
  766.                        ---------------------
  767.  
  768.    Note: VBBS uses true Ansi. Ansi.sys or similar device driver is required
  769. in your config.sys for Ansi display. To enable all BBS functions to
  770. work properly, DSZ.COM (or exe), LIST.COM, PKUNZIP.EXE, and
  771. PKZIP.EXE (all Shareware) should be in your path.
  772.         By executing VBBS using "BBS 1" (single node installation),
  773. you will bring up the program in the WFC mode. This is the online
  774. control panel for VBBS and in this screen, the BBS is in a "Waiting for
  775. call" state.
  776.  
  777. Logging on the first time:
  778. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  779. If your VBBS is a new installation, then the USERFILE.DAT (user accounts)
  780. file is empty. Use the (L)ogin Local from the WFC screen to Log yourself
  781. in as NEW, and create yourself a SYSOP account. Thereafter, you can use
  782. (F)ast Login. DO NOT use (F)ast Login until your sysop account has been
  783. created!
  784.                         ┌──────────────────┐
  785.                         │ Waiting For Call │
  786.                         └──────────────────┘
  787.   VBBS uses a highly informational WFC.COM screen. This screen not only
  788.   provides System statistics, time, drivespace and system status,
  789.   and BBS name, it is also customizable from within any Ansi Draw program
  790.   that saves screens to the .COM format. Note that if your drive space
  791.   on a given drive drops below 5% of capacity, that line will begin
  792.   flashing until more space has been freed up.
  793.  
  794.                           -CONTROL PANEL-
  795.   F) Fast Local Login - Fast login from console (Estab. SysOp acct 1st)
  796.   L) Login Local     - Logs you into the system (Use this to estab.
  797.                        Sysop account)
  798.   S) Shell to DOS    - Shells to Dos environment within VBBS
  799.   U) User Editor    - Allows editing of user information
  800.   V) VConfig        - The VBBS configuration utility
  801.   I) System Info     - "To date" information on your BBS
  802.   C) Today's Callers  - Log of callers since midnite
  803.   W) Who's Online   - Shows status of each port
  804.   /) Dial NET to CLIENT  - Allows a forced net callout to a system that
  805.                            is listed in your remote configuration
  806.   N) Dial NET to SERVER  - Forces a network connect to SERVER
  807.   E) Email - This function allows you to email local and network from
  808.              the WFC
  809.   M) Read All Mail - Sysop read all mail on system
  810.   Scr/Lock) Sysop avail. - Toggles sysop page (beep) on/off
  811.   Esc) Quit BBS  - Quits VBBS and returns to DOS
  812.  
  813.                     -DEFINABLE FUNCTION KEYS-
  814.  F-1 thru F-10 -  Configured in Vconfig to call up various batchfiles.
  815.                   (might be a term program, text editor or
  816.                   whatever) These keys are configured in the main.cfg
  817.                   using Vconfig.exe. Use of a LIST utility is
  818.                   needed to read the various log files.
  819. Note: If you encounter any program errors at this point, it is likely
  820. that you have either misstated a path in paths.cfg, moved a file to a
  821. wrong dir, or forgot to compile the V.Scripts. Use the Diagnostics
  822. option in Vconfig to isolate any problems.
  823.  
  824.  
  825.                                -16-
  826.  
  827.                      Creating The SYSOP Account
  828.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  829.  
  830.        From VBBS WFC, Login locally by pressing 'L'. You will first see
  831. the Login.txt screen from Virtual Reality BBS. This screen, as well as
  832. the logoff.txt screen will need to be replaced later with an ascii or ansi
  833. screen of your own creation.
  834.        Directly following the login.txt will be the login
  835. prompt. Type "New" to create the first entry into your user data file.
  836. You will then see the Newuser.txt followed by the prompts to fill out
  837. your user information. VBBS currently also allows the user to configure
  838. his default colors here as well. It may be best to choose "8" (none) at
  839. each prompt, and then experiment with the settings, once an account has
  840. been created and you are inside of the BBS.
  841.       Once your account has been created, you will login with mail
  842. waiting. This mail is a scripted auto New User mail from the sysop
  843. welcoming the new user. It is created from the "start.v" script and is
  844. an excellent place for you to later get your feet wet inside of the
  845. scripts by personalizing that mail. A "?" displays your email options at
  846. the end of the mail.
  847.       The following Hot keys are available to the console while a user is
  848. online:
  849.  
  850.  [F1]  Enter/Exit Chat Mode
  851.  [shift][F1] Enter/Exit Split Screen Chat
  852.  [F2]  Enter user editor
  853.  [F3]  Add 1 minute to user session
  854.  [Shift F3] Subtract 1 minute from user session
  855.  [F4]  Increases online user's SL by 5
  856.  [Shift F4] Decreases online user's SL by 5
  857.  [F5]  Drop to DOS
  858.  [F6] pseudo DOS multitasker (allows sysop to run small DOS commands
  859.       from the console while the user is online and navigating the BBS.
  860.  [F8] Sysop Alert (alerts sysop when board is free after user logs off)
  861.  [F10] Boot User Off
  862.  [shift][F10] Boot user with "storm.txt" (BBS coming down due to
  863.               inclimate weather conditions)
  864.  [Control-F10] Boot user off with "line noise"
  865.  [scroll lock] can be used at any time to toggle the "SysOp Available" status.
  866.  
  867.  
  868.    As you continue with creating your SysOp account, you will need to
  869. change your security level to 255 (maximum), and assign yourself a
  870. "max time" which is how many minutes per day a user is allowed on the
  871. system. For Sysop, make this 1440 (24 hours). By pressing F-2, you
  872. will call up the user editor to enable your editing of the appropriate
  873. fields.
  874.  
  875.  
  876.                             -17-
  877.  
  878. VBBS User Editor
  879. -------------------
  880. User No. 1          - Displays User #
  881. a. Handle  :        - User Handle
  882. b. Name    :        - User Real Name
  883. c. Address :        - Street or PO Box address
  884. d. City    :        - City
  885. e. State   :        - State
  886. f. Zip     :        - Zip code
  887. g. Security:        - User's Security level
  888. h. Flags   :        - (see note)
  889. i. PW      :        - User's Password
  890. j. Title   :        - (see note)
  891. k. Phone 1 :        - Voice Phone #
  892. l. Phone 2 :        - Data Phone #
  893. m. MaxTime :        - Maximum time allowed on per day
  894. n. Access Flags:    - (see note)
  895. o. Verify Birthday: - Displays user's Birthday. (see note)
  896. p. Ex1:                 q. Ex2:                 r. Ex3:
  897. s. Ex4:                 t. Ex5:                 u. Ex6:
  898. v. Ratio Exempt:    - Allows you to exempt user from Up/Down Ratio reqs.
  899. w. U/L:1                          x. D/L:    Sets Ratio for
  900.                                              up/downloading of files
  901. ANSI:Y Page Length: 24 Colors: 32 4 6 Calls:    Time: 12411 910807
  902. (a-v)=edit, Esc)Quit, Enter)Next, -)Previous, /)Find !)Delete->
  903.  
  904. Note:
  905. g. - Security levels are 1 thru 255 (255 being SysOp access). Default
  906. new user security levels are set in Vconfig {main}.
  907. h. - The use of flags - There may as many as 26 flags (a-z)
  908.    A - AutoPost at login time on/off
  909.    X - Expert mode
  910.    N - If set, has received the new user welcome message.
  911.    F - If set, user is configured for the full screen editor
  912. j. - This area can be used for one line notes concerning the current user.
  913. p. thru u. - Extra variables
  914.    $EXTRA1 - User's default message base #
  915.    $EXTRA2 - USer's deafult file base #
  916.    $extra3 - Kb uploaded
  917.    $extra4 - Kb downloaded
  918. o. - if toggled will ask user to re-enter his or her b'day at login.
  919. /  - Searches User list
  920. !  - Deletes user.
  921.  
  922.  
  923.                            -18-
  924.  
  925.  
  926. User Account Defaults
  927.  
  928. 1. ANSI Toggle       [ON]  - Toggles Ansi on/off
  929. 2. Expert Toggle     [OFF] - Expert mode will bypass the menu display
  930. 3. Page Breaks       [0]   - Defaults at 24. "0" = Continuous scroll.
  931. 4. Password                - User password
  932. 5. Auto-Posts        [OFF] - Toggles AutoPost display at login
  933. 6. Ctrl-A User Macro- Users can set up 2 seperate macros each containing
  934. 7. Ctrl-B User Macro- up to 79 chars including Ansi control chars.
  935. 8. ANSI Color Set-Up - Allows user to select screen display to taste.
  936. 9. Full Screen Editor [ON] - Toggles between FSE or Line editor.
  937. A. Mailbox: - Allows users to forward mail to another user or Network
  938.               system.
  939. B. Security- Displays list of things that the user has sufficient
  940.              security to do on the system.
  941. C. Long Distance Cost- Allows user to keep track of Lond distance
  942.                        usage and billing by defining cost per minute
  943.                        and knowing the billing cycle.
  944. Q. Quit - Saves changes and quits to main menu
  945.  
  946.  
  947.                                  ==*==
  948.  
  949.  
  950.                                  -19-
  951.  
  952.                            The Default setup
  953.                         ~~~~~~~~~~~~~~~~~~~~~~~~
  954.       VBBS could easily be distributed with a BLANK menu. Instead, a
  955.       default menu and Function Block set are provided with the
  956.       program reflecting the configuration of the software on the
  957.       Author's BBS.
  958.         Below is the START.FB (function block) which is provided with
  959.       VBBS 5.30. It corresponds exactly to what has been defined in
  960.       the MAIN menu (.ans/.asc). For more info on FBs, see
  961.       Customizing options.
  962.  
  963. MAIN
  964. A
  965. > 001 1 nextbase
  966. < 001 1 prevbase
  967. l 001 1 selectbase
  968. j 001 1 setquickscan
  969. s 001 1 scanmsg
  970. n 001 1 readnewmsg
  971. r 001 1 readseqmsg
  972. p 001 1 post
  973. e 001 1 sendemail
  974. y 001 1 reademailfrom
  975. m 001 1 reademailto
  976. q 001 1 quickmail
  977. f 001 1 feedback
  978. o 001 1 door
  979. z 001 1 telecon
  980. d 001 1 account
  981. c 001 1 pagesysop
  982. t 001 5 files
  983. b 001 1 textfiles
  984. k 001 1 listcallers
  985. u 001 1 listusers
  986. a 001 1 autopost
  987. v 001 1 vote
  988. i 001 1 sysinfo
  989. w 001 1 who
  990. x 001 1 listnet
  991. * 255 5 sysop
  992. G 000 1 logoffyn
  993.  
  994.  
  995.                              Menus
  996.                              ~~~~~
  997.  VBBS uses Ansi and Ascii Menus that can be created with your
  998.  favorite Ansi Draw program. VBBS comes with a complete menu set
  999.  (various .ans and .asc menus). You simply need to save your menus in
  1000.  the appropriate .ANS and corresponding .ASC menus. Note also that VBBS
  1001.  uses lines within both the main and transfer menus which are visible
  1002.  only to users with sec levels of 255 (sysop level). Newly saved Ansi
  1003.  menus will need to have these lines "tagged" into the menu using an
  1004.  ascii type editor. "!" is a VBBS comment line. "!" followed by 255
  1005.  tells VBBS to only display this line to users who have a security level
  1006.  of 255.
  1007.  
  1008.                             -20-
  1009.  
  1010.                        ---------------
  1011.                         The Main Menu
  1012.                        ---------------
  1013. Messaging functions
  1014. ~~~~~~~~~~~~~~~~~~~
  1015. L) List Bases - Brings up prompt to list available local and Networked bases.
  1016. P) Post a Message -  Post a message in the current base.
  1017. N) New message scan - New-scans all bases.
  1018. R) Read Sequential - Read messages in current base sequentially
  1019. S) Scan Brief - Scans posts in current base backwards in groups of 10,
  1020.                 showing the number, author and message subject.
  1021. J) Join/ Ignore Base - Allows users to set up bases to ignore or mark for
  1022.                        scanning.
  1023. >) Next Base - (or +) Next message base in sequence.
  1024. <) Previous Base - (or -) Previous base number.
  1025. #) Change to Base # - Change to a base by entering it's number.
  1026.  
  1027. Email functions
  1028. ~~~~~~~~~~~~~~~~
  1029. M) Mailbox Scan  - Displays all mail in user mailbox '*'= unread
  1030.                    N)Read New mail A)Read ALL mail Q)Quit
  1031. Y) Read Mail You've Sent - Displays list of all local mail sent as well
  1032.                            as all unbundled Network mail.
  1033. E) Write Email - Write email to another local or network user.
  1034. F) Feedback to the SysOp - Auto mails the SysOp
  1035. Q) Multimail- Users configured for Multimail usage may store up to 9
  1036.               seperate "mailing lists" which may include an unlimited #
  1037.               of local, VirtualNET and/or WWIVnet addresses. It is
  1038.               important that responsible Network usage of this feature
  1039.               is maintained.
  1040.  
  1041. BBS Sub-System
  1042. ~~~~~~~~~~~~~~~
  1043. T) File Transfer - This calls up the Files menu
  1044. B) Bulletin/Texfiles - General Textfiles available for reading
  1045. S) System info - Provides a display of VBBS system stats.
  1046. V) Voting Booth - Users are allowed to vote on polling questions posted
  1047.                   by the sysop or others as determained in $Vconfig7.
  1048. D) Defaults - User configurable default settings.
  1049. O) On-line Programs - Displays menu for games and other online programs
  1050.                       configured in Vconfig
  1051. A) Autoposts -  Displays AutoPosts
  1052.  
  1053. Other Functions
  1054. ~~~~~~~~~~~~~~~~
  1055. K) Today's Callers - A list of callers who have logged on today.
  1056. U) User Listing - The list of system users and their location.
  1057. I) System Info - Shows statistical chart of BBS usage.
  1058. C) Page SysOp - If the console scroll lock is selected to "on", this
  1059.                 will activate an audible page, otherwise count off
  1060.                 silently and then prompt the user to send email instead.
  1061. W) Who's Online - Shows status of console and each modem port
  1062. Z) Mutiuser Telecon. - This is the mutiuser teleconference feature that
  1063.                        allows users to chat beween nodes.
  1064. X) Network info - Displays Network BBSlist(s)
  1065. *) SysOp Menu - Go to Sysop function menu (displayed to 255 SL only)
  1066. G) Logoff    - Exits VBBS
  1067.  
  1068.                                -21-
  1069.  
  1070. SysOp Menu
  1071. ~~~~~~~~~~~~
  1072. M) Read All Mail  - Review all mail on system
  1073. E) Edit File      - Edit any file
  1074. U) User Editor    - User Editor
  1075. S) Security       - Displays Users with "security" status
  1076. C) Force Cleanup  - Force Daily cleanup
  1077. Q) Quit           - Quit to main menu
  1078.  
  1079.  
  1080.                                ==*==
  1081.  
  1082.                                -22-
  1083.  
  1084.                           Communications
  1085.                          ~~~~~~~~~~~~~~~~
  1086.         VBBS, in the default setup,  places all communications
  1087. functions in the main menu.
  1088.         The messaging function in VBBS provides an easy to use interface
  1089. for email and the posting of public messages. In addition to the standard
  1090. line editor for messages, VBBS also includes a built in full screen
  1091. editor which provides function in addition to that of line editor. Users
  1092. may set their default to whichever editor they prefer.
  1093.    A quoting feature is built in to VBBS and can be used in either editor.
  1094. Users are prompted whether or not to quote from a message when replying to
  1095. a mail or post. When a user choses to write mail or post, he or she will
  1096. also be asked by the program whether or not to upload a prepared text.
  1097. Choosing Yes will prompt for a filename followed by the upload. At the
  1098. end of an email, users whom have the proper security level are able to
  1099. attach a file to a piece of mail. Sysops may send attached files to email
  1100. accross the Network. The "FSE" in 5.30 has been improved to incluse
  1101. line by line scrolling, a cut and paste feature, Control code colors
  1102. and a built in Spell check dictionary (not included).
  1103.  
  1104. Note: Both VBBS editors as well as Post titles, and Autoposts are
  1105. capable ^P color enhancement (8 color WWIV style) and ^C codes
  1106. (reflecting the 28 option VBBS true ansi color selection).
  1107. A list of those colors is shown in the editor help screen.
  1108.  
  1109.  
  1110.  
  1111.  
  1112. Message sub-menu
  1113. ~~~~~~~~~~~~~~~~~~~
  1114. [ENTER] Next Message - Advances to next Message Base.
  1115. R) Reply to message -  Reply to the current message.
  1116. A) Read message again - Re-read the current message.
  1117. D) Delete Message - Delete the current message.
  1118. ###) Jump to Number ### -Entering a number will take you to that message
  1119. S) Scan Next 10 Messages - Scans forward.
  1120. B) Bypass Sub (QuickScan) - Bypasses msgs to next sub during Quickscan
  1121. E) Send Email Reply - Sends a private reply to a message.
  1122. Q) Quit Reading Messages - Returns to Communications menu
  1123. ----- SysOp -----
  1124. X) Extract Text - Extracts message to a textfile which is named by you.
  1125. M) Move Message - Moves message to a different message base.
  1126.  
  1127.  
  1128.                              -23-
  1129.  
  1130. Email sub menu
  1131. ~~~~~~~~~~~~~~~
  1132. [ENTER] Next Email - Advances to next mail
  1133. R) Reply To Email - Reply to email sent you
  1134. A) Re-Read Email  - Re-displays current message
  1135. L) Re-List Email Scan - Re lists messages in mailbox
  1136. D) Delete Email   - Deletes an email
  1137. Q) Quit Reading Email - Quits to communications menu
  1138. T) Download Attached File - If file is attached, this will allow the
  1139.                             remote user to download the attached file
  1140. ###) Read Mail number
  1141.    ---- SysOp ----
  1142. X) Extract Text - Allows SysOp to save & name a message to a textfile.
  1143. F) Forward  - Forward mail to another local or network user
  1144. V) Validate User - Goes to User editor to update User account
  1145.  
  1146.  
  1147.                            ==*==
  1148.  
  1149.                            -24-
  1150.  
  1151.                       Transfer Section
  1152.                       ~~~~~~~~~~~~~~~~~
  1153. FILES.FB
  1154. ~~~~~~~~
  1155. FILES
  1156. F
  1157. g 000 1 logoffyn
  1158. m 001 1 dlmasterlist
  1159. u 001 1 remoteupload
  1160. d 001 1 downloadfile
  1161. r 001 1 reviewfile
  1162. c 001 1 selectbase
  1163. j 001 1 setquickscan
  1164. l 001 1 listfiles
  1165. n 001 1 newfiles
  1166. s 001 1 searchall
  1167. b 001 1 batchdl
  1168. f 001 1 findfiles
  1169. > 001 1 nextbase
  1170. < 001 1 prevbase
  1171. p 001 1 topdownloads
  1172. y 001 1 ratio
  1173. z 255 1 sysopupload
  1174. x 255 1 reviewuploads
  1175. q 000 5 start
  1176.  
  1177.  
  1178. Files Menu
  1179. ~~~~~~~~~~
  1180. C) Change directory- Displays list of dirs and prompts for dir change
  1181. L) List Files *.*  - Lists all files in the current dir.
  1182. S) Search All Dirs - Searches for filenames based on
  1183. D) Download Files  - Download file(s)
  1184. R) Review Files    - Browse files in current directory
  1185. N) New files - Scans files that are new since last call.
  1186. U) Upload Files    - Prompts user for files to upload
  1187. B) Batch Functions - Used to mark and then download multiple files
  1188. Y) Your Transfer Stats - Displays users transfer statistics
  1189. P) Popular D/Ls   - Searches and compiles display of top user downloads
  1190. J) Join/Ignore Dirs- Sets dir to include or ignore in newscan
  1191. K) Default File Dir- Dir that user defaults to (#1 if not set)
  1192. F) Find Description- Finds file through keyword searches in file
  1193.                      descriptions
  1194. >) Next Directory  - (or +) Advances to next file directory
  1195. <) Previous Directory - (or -) Reverses to previous directory
  1196. #) Change to Dir. #  - Entering a dir number will take you to that dir
  1197. M) Master List  - Creates Masterlist of Files for user to download.
  1198. Q) Quit  - Quits to main menu
  1199. G) Log Off - Exits VBBS
  1200. ---- SysOp ----
  1201. X) Sysop Directory - Review NEW uploads to Sysop Directory
  1202. Z) Local Upload   -  Uploads files to directory.
  1203.  
  1204.  
  1205.                              -25-
  1206.  
  1207. Filesub menu
  1208. ~~~~~~~~~~~~~~
  1209. [ENTER] Next Entry - Advances to next file or file listing
  1210. D) Download     - Download Current file (? displays options)
  1211. B) Batch Functions - Add files to "batch queue" (for multiple file
  1212.                      transfers)
  1213. A) List Again   - Re-displays the current file
  1214. ###) Jump to ### - Jumps to file number pressed
  1215. Q) Quit - Quit to Files menu
  1216. B) By-Pass (New Files Scan) - Bypass current dir in newscan
  1217. V) View Archive - View the contents of the archived file
  1218. R) Request NET File - Allows user to request a file from it's networked
  1219.                       file listing. SysOp will be prompted to Approve or
  1220.                       Disapprove a request (also for local offline files)
  1221. T) Test ZIP - Allows the testing of the current file with a virus
  1222.              scanning software such as SCAN (not included) This feature
  1223.              is currently ONLY available for .ZIP files
  1224. ---- SysOp ----
  1225. O) Move File Offline/Online- Toggles file to/from diskette or Tape drive
  1226.                              Can also just toggle the file's availability
  1227. Z) Add ZIPCOMNT.TXT to ZIP - Manually adds Zipcomnt.txt to archive
  1228. X) Remove File - Remove filelisting and/or file from current dir.
  1229. C) Copy File   - Copies file from one directory to another.
  1230.  
  1231.  
  1232.                                ==*==
  1233.  
  1234.                                -26-
  1235.  
  1236.  
  1237.                        Multiuser Teleconference
  1238.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1239.         The Multiuser Teleconference is a simple demonstration of an
  1240. internode "chat" setup. It has been internalized into the exe for
  1241. speed. Even if you are running only one node under Windows or Desqview,
  1242. you can run multiuser by running one node from the BBS 1 command
  1243. and one from a BBS 0 commandline.
  1244.  
  1245.  
  1246.                             Autoposts
  1247.                           ~~~~~~~~~~~~
  1248.         Autoposts are Networkable electronic Post-It notes that appear
  1249. at program login or from choosing their display from the main menu.
  1250. Users who have the appropriate security level may post a 3 line message
  1251. for display. The most recent 5 autoposts are displayed.
  1252.  
  1253.                          Random Messages
  1254.                         ~~~~~~~~~~~~~~~~~
  1255.     A "random message" feature is included with VBBS which
  1256. displays a one (or up to three) line message each time the main menu is
  1257. displayed. It is configured in Vconfig.
  1258.  
  1259.                           Chat Screens
  1260.                          ~~~~~~~~~~~~~~
  1261.    VBBS uses a special Chat feature which splits the screen into TWO
  1262. halves. The upper half of the screen for the sysop, the lower half for
  1263. the user. The User's name appears at the bottom end of the screen and
  1264. the Sysop's name appears at the very top. Split screen can be called at
  1265. any time by using [shift][F1]. Normal chat is called by pressing [F1].
  1266.  
  1267.  
  1268.                          System Taglines
  1269.                         ~~~~~~~~~~~~~~~~~
  1270. VBBS now uses a file called TAGLINE.### for system taglines. This
  1271. multiline tagline may either be created in an ascii editor, or made with
  1272. your favorite Ansi Draw program (note that Ansi taglines must be limited
  1273. to a line legnth of 80 columns). The ### signifies a number between 1
  1274. and 999. You may have as many as 999 taglines (TAGLINE.1 , TAGLINE.2
  1275. etc). Taglines are defined in each DATABASE. 0 means no tagline will
  1276. be used. Note NOT to define taglines for ONELINERS, or FILES.
  1277.  
  1278.  
  1279.  
  1280.           -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1281.  
  1282.                                -27-
  1283.  
  1284.                          Customizing VBBS
  1285.                         ~~~~~~~~~~~~~~~~~~
  1286.         The configurability of VBBS cannot be overstated.
  1287.  
  1288.          You may easily modify VBBS to look and feel like some other
  1289. BBS software. You may borrow features from several different BBS
  1290. softwares to form one of your own design. You might just go absolutely
  1291. nuts one night and decide to make VBBS emulate GEnie (or other CIS). Aside
  1292. from obvious limitations in actual STORAGE, you could accomplish this to
  1293. the point where a user could not tell the difference! It is doubtful
  1294. that anyone would actually want to RUN a BBS that looked exactly like
  1295. GEnie. This was just used as an illustration as to the capabilities of
  1296. script customization.
  1297.       Unlike source code, which normally contains strict rules on code
  1298. segment distribution (VBBS included), Vscripts as well as Function
  1299. Blocks and menus may be distributed freely in full, or even in entire
  1300. configuration sets.
  1301.  
  1302.  
  1303. Creating and Editing Vscripts- The ability to create and edit scripts is
  1304. completely self contained. You simply need to use your favorite text
  1305. editor or word processor and of course become somewhat familiar with the
  1306. Vscript language. (see Vscript.doc)
  1307.  
  1308. Compiling the Vscripts- VBBS includes a special compiler (VCOM.EXE),
  1309. that is used to compile the .V script text into code.
  1310.  
  1311.  
  1312.                             -28-
  1313. ----------------
  1314. Function Blocks:
  1315. ----------------
  1316. Creating and editing Function Blocks- Function Blocks are simple ascii
  1317. files residing in the MAIN VBBS dir.
  1318.  
  1319. The syntax for their use is:
  1320.  
  1321. <menu file (8 chars max)>
  1322. <database group attached to this FB>  (if any)
  1323. <one or more lines of the following, in strict columns:>
  1324. 1 3   7 9+
  1325. x yyy z ccccccccccccccc
  1326.  
  1327. x=Key to assign
  1328. yyy=Security Level (must be 3 digits (like 001))
  1329. z=command type
  1330.   0= Null (no operation)
  1331.   1= Internal command (like SENDEMAIL)
  1332.      (Any one word script command will work)
  1333.   2= Script
  1334.   3= DOS function (don't shrink)
  1335.   4= DOS function (shrink)
  1336.   5= TRansfer control to a different function block
  1337. c=command string
  1338. -------
  1339. an example FB might look like:
  1340. -------
  1341. EMAIL    (name of menu file)
  1342.          (no database attached (email is automatic))
  1343. E 001 1 sendemail
  1344. M 001 1 reademailto
  1345. F 001 1 feedback
  1346. S 001 1 reademailsent
  1347. Q 000 5 START (on Quit, return to START FB)
  1348. -------
  1349. For msg bases:
  1350. -------
  1351. MSG
  1352. A        (since this references group A, A is the attached dbgroup)
  1353. R 001 1 readseqmsg
  1354. N 001 1 readnewmsg
  1355. P 001 1 post
  1356. C 001 1 selectbase
  1357. > 001 1 nextbase
  1358. < 001 1 prevbase
  1359. Q 000 5 START
  1360. -------
  1361. START.FB must be the first FB run. It is to be the MAIN FB of a BBS.
  1362. It takes control immediately after START.V finishes running.
  1363.  
  1364.        Once you are a VirtualNET node, you will be able to access the
  1365. SysOp sub message bases which includes the Vscripts discussion sub as
  1366. well as the Vscripts FBs and Mods networked File directory.
  1367.  
  1368.           <Please see Vscript.doc for detailed script info>
  1369.  
  1370.                              -29-
  1371.  
  1372. The Source
  1373. ~~~~~~~~~~
  1374.  VBBS may also be modified through "source mods" by Sysops who have
  1375.  registered at the SOURCE level. Sysops are encouraged to share their
  1376.  modifications with others and in fact, specific "sub" areas have been
  1377.  devoted to this on both VirtualNET and WWIVnet.
  1378.  
  1379.     -=-==-=-=-=-=-=--=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  1380.  
  1381.                              -30-
  1382.  
  1383.                          Optimizing VBBS
  1384.                         ~~~~~~~~~~~~~~~~~
  1385.   Aside from the frequent running a disk speedup/optimization utility,
  1386. A VBBS installation can be optimized further by the use of Ramdrive.
  1387. Although it is not at all nescessary to do so, if you have the RAM to
  1388. spare, further improvement to system speed can be made this way.
  1389.  
  1390. Use of a RamDrive
  1391. ~~~~~~~~~~~~~~~~~~
  1392.     A VBBS installation can be optimized through the use of a RAMDRIVE
  1393. (virtual disk). By loading some of the smaller, frequently accessed
  1394. files into RAM memory, many systems will apreciate system speed up
  1395. ranging from modest to substantial.
  1396.  
  1397. The CONTROL.DAT directory probably benefits the most from being
  1398. located on a RAM drive. CONTROL.DAT is the "buffer" or channel
  1399. between two or more nodes, and is as well, the file that holds temporary
  1400. status information about who is logged onto the system.
  1401.  
  1402. VBBS Textfiles and Menus within the TEXT directory can be put on a RAMDRIVE.
  1403. These would be the *.TXT, *.ASC, and *.ANS files. Because they are frequently
  1404. used, loading them into RAM can reduce hard disk access substantially.
  1405.  
  1406. Last, the SCRIPT directory can be put on a ramdrive. These would be the
  1407. *.COD and *.LIT files. Putting your script files on the ramdrive speeds
  1408. the process of loading the scripts.
  1409.  
  1410. In a typical installation, RAMDRIVE installs in the following manner:
  1411. DEVICE=RAMDRIVE.SYS 80 /E
  1412. The "80" refers the size of the desired ram disk in kilobytes.
  1413. The "/E" locates the ram disk in extended memory.
  1414. (In order to use this option, you need to be running a 286 or 386, with at
  1415. least 1 megabyte of ram, and with either HIMEM.SYS (An Extended Memory
  1416. Manager), or QEMM386 (if you have a 386) installed.
  1417. Leaving the "/E" part off puts the ram disk in conventional memory.
  1418.  
  1419.  
  1420.  
  1421.  
  1422.        -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1423.  
  1424.                               -31-
  1425.  
  1426.                            - Security-
  1427.                           ~~~~~~~~~~~~~
  1428.  
  1429.         VBBS provides a high level of security. One of the most
  1430. significant security features of VBBS is that it will not allow a remote
  1431. user to drop to Dos. If you would would like to enable a Remote Dos
  1432. capability, you will need to install Doorway (shareware), RemDos
  1433. (shareware), or other program to run as a door in VBBS. This is generally
  1434. a much safer method, and in the case of using "Doorway" provides a much
  1435. more powerful remote interface.
  1436.         In Vconfig, you have the option of allowing Remote Sysop.
  1437. Allowing a remote Sysop will let users with a security level of 255 (who
  1438. know the current system password) to access the SysOp functions of VBBS
  1439. EXCEPT accessing Dos. Pressing "S" from the SysOp menu will show all
  1440. users on the system who have security level access. Although a user may
  1441. view an archive, there is no function that will allow him or her to
  1442. extract an archive. As with all BBS software, it is recomended that you
  1443. use a registered Zmodem.
  1444.        New since VBBS 5.21 is a SysOp "UPLOAD" directory to which ALL
  1445. files uploaded to the system are automatically uploaded to. Here, the
  1446. sysop has the ability to view, scan and move the files and file listings
  1447. to the appropriate directory after review. Be sure to leave the
  1448. security settings at 0 for this database and also insure that DSZ.COM
  1449. is either IN your path or in the UPLOAD dir itself.
  1450.  
  1451.  
  1452.  
  1453.        -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1454.  
  1455.  
  1456.                                -32-
  1457.  
  1458.                   Explanation of files used by VBBS
  1459.                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1460. VBBS expects to find these files in your system text directory as
  1461. specified by VCONFIG System Paths Configuration.
  1462.  
  1463. LOGIN    ANS      Your system's login screen
  1464. LOGIN    ASC      Ascii version of above
  1465. LOGOFF   TXT      Displayed to user at logoff
  1466. NEWUSER  TXT      Displayed to new users before sign-up
  1467. COLORS   TXT      Menu for selecting user's default ANSI colors
  1468. EMAILHLP TXT      Help File for addressing email/netmail
  1469. EDITHLP  TXT      Help File for line editor
  1470. FEDITHLP TXT      Help File for full-screen editor
  1471. WFC      COM      SysOp's Waiting-for-caller Menu
  1472. TRASHCAN TXT      Ascii file containing words disallowed in user handles.
  1473. STORM    TXT      Used as an emergency logoff screen to online users
  1474. (various)LOG      System activity log files
  1475. (various)CFG      System configuration files produced by Vconfig
  1476. (various)NET      Network files
  1477. (various)V        Script files
  1478.   "      COD      "         "
  1479.   "      LIT      "         "
  1480.  
  1481. START     FB      Start function block (main menu)
  1482. FILES     FB      Files  "       "     (files menu)
  1483. SYSOP     FB      Sysop  "       "     (Sysop menu)
  1484. INSTALL  EXE      VBBS Auto install program
  1485. VBBS     EXE      Main VBBS executable
  1486. VNET     EXE      Network executable
  1487. VCONFIG  EXE      VBBS Configuration program
  1488. VCOM     EXE      VBBS Vscript compiler
  1489. BBS      EXE      Resident program used to execute the VBBS and pass %
  1490.                   parameters to the program (must also include correct
  1491.                   path to your DSZ)
  1492. SERIAL   BIN      Assembly language handling of serial routines
  1493.  
  1494.  
  1495. Dorinfo1.def chain.txt are files that are produced to pass needed
  1496. information to online programs being run from the BBS.
  1497.  
  1498.             -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1499.  
  1500.                               -33-
  1501.  
  1502.                     VirtualNET Network Information
  1503.                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1504. VirtualNET is the networking feature of the Virtual BBS. VirtualNET, in its
  1505. early beginning stages, has been on-line for 11 months as of this update.
  1506. You will find VirtualNET easy to become setup with, and alot of fun to
  1507. participate in. VirtualNET is free from the politics that may be found
  1508. on other networks.
  1509.  
  1510. Come, join us! Networking your BBS with VirtualNET is quick, easy and more
  1511. affordable than you might think. A typical network call at 2400 baud
  1512. takes only one or two minutes, due to the efficiency of the design.
  1513. Network "packets" are automatically ZIPped for transmission, reducing
  1514. the length of the transfer to 1/3 of sending unZIPped data.
  1515.  
  1516. The main mail server is located in Western Michigan, and utilizes a
  1517. US Robotics HST 14400 bps modem. It is available for network transfers
  1518. 24 hours a day.
  1519.  
  1520. The author is currently the Network Coordinator, and is always ready to
  1521. assist you. Registration is NOT required to join the network. We welcome
  1522. everyone!
  1523.  
  1524. Setting up is EASY! Join the national NET Today!
  1525.  
  1526.  
  1527.     It is anticipated that other Networks will be added to the Multi-Net
  1528.     in very near future.
  1529.  
  1530. * Please see NETGUIDE.DOC for information on VirtualNET and the
  1531.   VNET.EXE
  1532.  
  1533.  
  1534.  
  1535.                                      -34-
  1536.  
  1537.                           VBBS/NET Registration
  1538.                          ~~~~~~~~~~~~~~~~~~~~~~~
  1539.  
  1540.            REGISTRATION:           Only $35.00 !
  1541.  
  1542.                   The current cost of a Basic VBBS LIFETIME registration
  1543.                   is ONLY  $35.00.  This makes VBBS affordable to all
  1544.                   and an unsurpassed value in telecommunications software.
  1545.                   Your registration of this young and fast growing program
  1546.                   enables you to become a part of it's continuing
  1547.                   developement. You will receive a life-time registration #.
  1548.                   as well as access to VWW4.EXE and other available
  1549.                   VBBS utilities which will make your VBBS even MORE
  1550.                   powerful.
  1551.  
  1552.  
  1553.  
  1554.                   Source Code:
  1555.                   the VBBS SOURCE code, is available on a continuing
  1556.                   basis to registered VBBS sysops for a seperate one
  1557.                   time registration fee of $25.00
  1558.  
  1559. **** Please note that if you register your VBBS prior to 11-30-91, you
  1560. **** will recieve the VBBS source code FREE!  (see MAIL_REG.TXT)
  1561.  
  1562.            
  1563.  
  1564.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1565.  
  1566.                                 -35-
  1567.  
  1568.                             The Future
  1569.                            ~~~~~~~~~~~~
  1570.         VBBS is a software that does not stand still. The near future
  1571. will find VBBS with further enhancements and system features through the
  1572. wizardry of it's author and through the input of the growing number of
  1573. VBBS SysOps that are beginning to assemble nationwide.
  1574.         Plans for the immediate future include as always, the continuing
  1575. and regular occurence of improved, new and added features that find thier
  1576. way into the program in each successive release.
  1577.  
  1578.  
  1579.  
  1580.  
  1581.      =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  1582.  
  1583.  
  1584.  
  1585.                             ACKnowledgements
  1586.  
  1587.           DSZ.COM is an external protocol driver product by
  1588.                        Omen Technology, Inc.
  1589.  
  1590.         PKZIP and PKUNZIP are archive programs by Phil Katz.
  1591.  
  1592.      DOS Programmer's Reference by Terry R. Dettmann (QUE Books).
  1593.  
  1594.                      Portions of the code are
  1595.             Copyright (C) Microsoft Corporation 1985-1988.
  1596.  
  1597.             Windows 3.0 is a product of Microsoft Corporation.
  1598.  
  1599.      Desqview, Desqview 386, and QEMM are products of Quarterdeck.
  1600.  
  1601.  
  1602.  
  1603.  
  1604.    =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  1605.  
  1606.                               -36-
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.           For More on VBBS: Virtual Reality BBS
  1615.                             616-399-4818  24hrs
  1616.                             USRobotics HST (300 to 14,400 bps)
  1617.                             (fast file xfers! sysop support BBS!)
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629. --------------------------------------------------------------------------
  1630.  
  1631.                                 -37-
  1632.  
  1633.  
  1634.                            About the Author
  1635.  
  1636. Roland DeGraaf is 26 years old and does not sleep. Earning a following
  1637. as a gifted programmer and program developer in Western Michigan, Roland's
  1638. passion for the past year has been the continuing developement of the Virtual
  1639. BBS software.
  1640.   Born in 1964 with detached retnas from a premature birth, Roland is legally
  1641. blind. Although his sight is very weak, his vision is intense and focused.
  1642.   Roland is blessed with both photographic and audiographic memory, but
  1643. above all else, he is blessed with a drive to excel.
  1644.   Under the deft helmsmanship of Roland De Graaf, VBBS continues sailing
  1645. into the virtual blue water of the modeming cyberspace.
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                            =-=-=-*-=-=-=
  1653.               VBBS/NET SysOp Documentation (C) 1991 J.Jaros
  1654.  
  1655.